home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / program / jtalkexe.zip / README.TXT < prev   
Text File  |  1996-07-16  |  18KB  |  443 lines
  1.                           Olivetti JavaTalk
  2.                           =================
  3.                              1996 07 16
  4.  
  5.                         JavaTalkClient v. 1.25
  6.                         JavaTalkServer v. 1.17
  7.  
  8.                   (c) 1996 Olivetti Research Limited
  9.  
  10. INDEX:
  11.     Introduction
  12.     Licence and copyright
  13.     What do you need?
  14.     Connecting as a user
  15.     Running a JavaTalk server
  16.     Acknowledgements
  17.     Packing list
  18.     Contact information
  19.  
  20.     
  21.  
  22. Introduction
  23. ------------
  24.  
  25. JavaTalk is a simple but effective multiuser chat program. Someone
  26. somewhere runs the server software and installs a suitable web page,
  27. then everyone else can join the chat by simply going to that page with
  28. their browser. You go to that page and whatever you type appears on
  29. the screen of everybody else who is watching the page at the same
  30. time. As simple as that! No messing around, no software installation,
  31. no client software to run, no command set to learn. If you want to
  32. give it a test drive, come to
  33.  
  34.         http://badges.cam-orl.co.uk/~fms/javatalk
  35.  
  36. Writing a chat system in Java has been a popular idea with many
  37. developers and if you search the web you'll certainly find many more
  38. implementations. I know of at least four more. So what has JavaTalk
  39. got for you that makes it better than the others? Well -- that's up to
  40. you to decide, but here are three basic reasons to consider.
  41.  
  42. * SIMPLE. No complicated command set to remember. No operators, chat
  43. rooms, privileges, private whispers or any of that stuff. Just go to
  44. the JavaTalk page and anything you type is seen by everyone else. Zero
  45. training needed.
  46.  
  47. * SMALL. The classes for the client software total less than 15K. That
  48. means quick loading time, even on slow links.
  49.  
  50. * FREE. Because I've got a smart boss, both the executable and the
  51. source are available to you for free, no licence form to fill in, no
  52. questions asked. You can use it as you wish on your own web pages, or
  53. as an internal communication facility in your intranet.
  54.  
  55.  
  56.  
  57. Licence and copyright
  58. ---------------------
  59.  
  60.     Copyright (c) 1996 Olivetti Research Limited
  61.  
  62.     Permission is hereby granted, without written agreement and
  63.     without licence or royalty fees, to use, copy, modify, and
  64.     distribute this software and its documentation for any purpose,
  65.     provided that the above copyright notice and the following three
  66.     paragraphs appear in all copies of this software, its documentation
  67.     and any derivative work.
  68.  
  69.     In no event shall Olivetti Research Limited be liable to any party
  70.     for direct, indirect, special, incidental, or consequential damages
  71.     arising out of the use of this software and its documentation, even
  72.     if Olivetti Research Limited has been advised of the possibility of
  73.     such damage.
  74.  
  75.     Olivetti Research Limited specifically disclaims any warranties,
  76.     including, but not limited to, the implied warranties of
  77.     merchantability and fitness for a particular purpose. The
  78.     software provided hereunder is on an "as is" basis, and Olivetti
  79.     Research Limited has no obligation to provide maintenance,
  80.     support, updates, enhancements, or modifications.
  81.  
  82.     Derived or altered versions must be plainly marked as such, and
  83.     must not be misrepresented as being the original software.
  84.  
  85.  
  86.  
  87. What do you need?
  88. -----------------
  89.  
  90.  * To participate as a client:
  91.  
  92.     You need a Java-enabled browser. Then simply connect to a page
  93.     that runs a JavaTalk server (like for example the JavaTalk home
  94.     page mentioned above) and tell your friends to join you there at
  95.     the arranged time.
  96.  
  97.     You don't need to download anything, neither the executable nor
  98.     the source release of JavaTalk. Everything you need will be picked
  99.     up automatically by your browser as and when you visit the web
  100.     page.
  101.  
  102.  
  103.  * To run your own JavaTalk server:
  104.  
  105.     You need the ability to run a Java interpreter on the same machine
  106.     as your web server.
  107.  
  108.     Grab the executable release, unpack it in its own directory, edit
  109.     the example web page if you want to, and launch the server.
  110.  
  111.  
  112.  * To modify the program:
  113.  
  114.     You need a Java compiler and developer's kit. Currently available
  115.     for free from Sun, as well as for money from commercial vendors.
  116.  
  117.     Grab the source release.
  118.  
  119.  
  120. All of the above, plus info on newer versions if any, can be found on
  121. the JavaTalk home page (see "contact info" at the end of this file).
  122.  
  123.  
  124.  
  125. Connecting as a user
  126. --------------------
  127.  
  128. Most of what appears in this section should be easy to figure out
  129. without instructions, but I'll spell it out in detail just so that you
  130. have a reference handy.
  131.  
  132. Go to the page of the JavaTalk server you want to connect to. The fact
  133. of going to the page makes your browser download the applet and
  134. connects you to the JavaTalk server.
  135.  
  136. When the applet has loaded you'll see two windows: a big one above and
  137. a one-line one below. You type, one line at a time, in the one-line
  138. window, pressing Enter after each line. What you type is sent to the
  139. server which then echoes it back to the upper window of everyone who
  140. is connected.
  141.  
  142. The echoed lines are prefixed with the name of the sender. You can set
  143. your name to whatever you want by using the command "MYNAME xxx"
  144. (commands are all uppercase so that they are unlikely to clash with
  145. anything you normally type). Replace xxx with your chosen name, of
  146. course. Don't choose a terribly long name or there won't be much room
  147. left for your messages and people will have to scroll horizontally,
  148. which is a nuisance.
  149.  
  150. Before you use MYNAME for the first time, your default name will be
  151. the internet address and port number of the socket you are using to
  152. connect to the server.
  153.  
  154. To see who else is connected to the server at the time, type "WHO"
  155. (the second and last command understood by the current version of the
  156. server).
  157.  
  158. If you don't type anything for a while, the server will suspect that
  159. you went away and will warn you. If you want to stay in, type
  160. something (and press Enter to send it). Otherwise, after another
  161. little while, you'll be disconnected.
  162.  
  163. (Technical note: this reaping process is performed to get rid of those
  164. zombie users who used to appear as connected even though they had long
  165. since gone away. It turns out that a known bug (SUN bug 1234731, see
  166. http://java.sun.com/java.sun.com/products/JDK/1.0.2/KnownBugs.html) in
  167. the Windows implementation of the Java socket libraries prevented the
  168. JavaTalk server from detecting that they had gone away. So I
  169. pre-empted the problem by kicking out inactive users, regardless of
  170. whether their socket looked OK or not. If you run your own JavaTalk
  171. server, you can customise the timeouts.)
  172.  
  173. When you are disconnected from the server, either because the server
  174. kicked you out or because the server couldn't be contacted on the
  175. given address and port (maybe because it wasn't running?) then the
  176. applet will not display any windows or buttons: it will just say "Not
  177. connected to server. Threads stopped." To reconnect (assuming the
  178. server is there to connect to), just reload the page.
  179.  
  180. Every time you leave the page, you disconnect from the server (though
  181. of course you won't see the above message because the applet won't be
  182. visible any more). The other participants to the conference will get
  183. the message "User xxx left the conference". Conversely, every time you
  184. enter the page, you join the conference and again the others are
  185. notified.
  186.  
  187. There are two checkboxes at the bottom of the applet that activate a
  188. debugging feature to measure the time it takes for your messages to
  189. travel from you to the server and back (the roundtrip delay). This is
  190. done by sending a special extra timestamp line every time you send a
  191. regular line. The server doesn't do anything special-- it just echoes
  192. the timestamp like it does with every other line. Your client, though,
  193. recognises it when it gets it and with some advanced mathematics
  194. (namely a subtraction) it computes how long the message took to get
  195. back. This time is then printed in the prompt that preced